IBM Books

8371 Interface Configuration


Configuring and Monitoring ATM

This chapter describe the ATM interface configuration and operational commands. It includes the following sections:


Accessing the ATM Interface Configuration Process

Use the following procedure to access the configuration process.

  1. At the OPCON prompt, enter talk 6. (For more detail on this command, refer to "What is the OPCON Process?".) For example:
    * talk 6
      Config>
    

    The CONFIG prompt (Config>) displays on the console. If the prompt does not appear when you first enter configuration, press Return again.

  2. At the CONFIG prompt, enter the list devices command to display the network interface numbers for which the device is currently configured.
  3. Enter the network command and the number of the ATM interface you want to configure. For example:

    The ATM configuration prompt (ATM Config>), is displayed.


ATM Configuration Commands

This section summarizes the ATM configuration commands. Enter the commands at the ATM config> prompt.

Table 33. ATM Configuration Command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Interface   Displays the ATM Interface Config> prompt from which you can list, change, or configure the ATM Interface. 
  • Add an ESI.
  • List the current configuration or list ESIs.
  • Remove an ESI.
  • Set parameters of the ATM network.
  • Enable or disable an ESI.
  • Exit
 Le-client   Displays the LE Client Config> prompt from which you can list, change, or configure the LAN Emulation Client Interface as described in "Using LAN Emulation Clients"
  • Configure a LEC by network #. This command displays the LE Config> prompt, from which you can configure a specific LAN Emulation Client (LEC).
  • List LAN Emulation Clients (LECs).
 Assign-lec   Assigns a specified LEC to an ATM interface. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".


ATM Interface Configuration Commands

This section summarizes and then explains the commands for configuring a specific ATM interface.

Enter the commands at the ATM INTERFACE> prompt.

Table 34. ATM INTERFACE Configuration Command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Add   Adds an ESI. 
 List   Lists the current configuration or list ESIs. 
 Qos   Displays the ATM I/F 0 QOS Config> prompt from which you can configure Quality of Service as described in "QoS Configuration"
 Remove   Removes an ESI. 
 Set   Sets parameters of the ATM network. 
 Disable   Disables an ESI. 
 Enable   Enables an ESI. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Add

Use the add command to add an ESI to your ATM configuration.

Octets 14-19 of an ATM address are the End System Identifier (ESI). Each end system attached to the same switch must use a disjoint set of ESIs. When an end system activates, it attempts to register its ESIs with its ATM switch using ILMI. The switch forces all of its registered ESIs to be unique.

Syntax:

add
esi esi-address

esi esi-address
Address of End System Identifier.

Valid Values:
Any 12 hexadecimal digits

Default Value:
none

List

Use the list command to list the configuration of this ATM device or to list the set of configured ESIs.

Syntax:

list
configuration

 
esi

configuration
Lists the ATM device configuration. For an explanation of the listed fields, see "Set".

Example: list con

                         ATM Configuration
 
  Interface (net) number =     36
  Maximum VCC data rate Mbps   =      155
  Maximum frame size    = 1664
  Maximum number of callers =  209
  Maximum number of calls =  1024
  Maximum number of parties to a multipoint call =  512
  Maximum number of Selectors that can be configured  =  200
  UNI Version = UNI 3.0
  Packet trace = OFF
  ATM Network ID =    0
 

esi
Lists the ESIs in the ATM configuration.

Example: list esi

  ATM INTERFACE> list esi
 
          ESI                Enabled
  ------------------------   -------
  000000000009                  YES
  000000000100                  YES
 
 

QoS Configuration

Use the qos-configuration command to display the ATM I/F 0 QOS Config> prompt from which you can configure Quality of Service as described in "QoS Configuration".

Syntax:

qos-configuration
 

Remove

Use the remove command to remove an ESI from your ATM configuration. All ATM components using this ESI should be reconfigured to use a different ESI. An ATM component that attempts to use a removed ESI may not activate on the next device restart.

Syntax:

remove
esi esi-address

esi esi-address
Address of End System Identifier.

Valid Values:
Any 12 hexadecimal digits

Default Value:
none

Set

Use the set command to specify ATM network parameters.

Syntax:

set
max-callers

 
max-calls

 
max-config-selectors

 
max-data-rate

 
max-frame

 
max-mp-parties

 
network-id

 
trace

 
uni-version

max-callers
Sets the maximum number of entities on the device that use the ATM interface. Each LEC qualifies as a user of the ATM interface. Increasing this parameter allows more users of the interface and uses more system memory.
Valid Values:
An integer in the range 64 - 1024
Default Value:
209

Example:

  ATM INTERFACE> set max-callers 25

max-calls
Sets the maximum number of switched virtual circuits (SVCs) that can exist on this ATM device. Every point-to-point and point-to-multipoint SVC uses system resources. This parameter helps limit the system resources reserved for signaling and switched connections. Increasing this parameter will allow more simultaneous SVCs. However, more system memory will be required to manage these connections.
Valid Values:
An integer in the range 64 - 10500
Default Value:
1024

Example:

  ATM INTERFACE> set max-calls 500

max-config-selectors
Sets the maximum number of selectors under your specific control.

The selector is used to distinguish different users on the same end system. VCC setup requests are routed in the following hierarchical fashion: ATM switches route to the destination ATM switch using the Network Prefix, the destination ATM switch routes to the destination end system using the ESI, and the end system notifies the destination user based on the selector.

Each ESI can have up to 255 associated selectors (0x00 through 0xff). The range of selectors is partitioned into two subranges, a configured selector range and an automatically assigned selector range. The ATM interface parameter max-configured-selector gives the upper bound on the configured selector range.

The relative sizes of the selector range can be modified to conform to the types and numbers of ATM users on the device.

Valid Values:
0 - 255 (0x00 - 0xFF)
Default Value:
200
Note:The selector is byte 20 of a 20-byte ATM address.

Example:

  ATM INTERFACE> set max-config-selectors 225

max-data-rate speed
Sets the default and upper bound for VCC traffic parameters of most LANE connections. For example, this is the default PCR for best-effort VCCs initiated by LE Clients. Signaled SCRs and PCRs cannot exceed this limit. The default value should be satisfactory in most situations. An example of a situation where it is beneficial to change this value would be if the majority of the stations use 25-Mbps adapters. In this case, it may be desirable to limit the data rate on VCCs to 25 Mbps so that the lower speed stations are not overwhelmed with frames from the device. The units for this parameter are Mbps.
Valid Values:
25
 
100
 
155
Default Value:
155

Example:

  ATM INTERFACE> set speed 155

max-frame
Sets the maximum number of octets permitted in any data frame sent or received on the ATM interface. System memory is allocated based upon this parameter. Increasing the max-frame requires more system memory, but allows processing of larger frames.

All device entities using the ATM interface must use a maximum frame size less than or equal to the max-frame-size of the ATM interface.

Valid Values:
An integer in the range 512 - 31000
Default Value:
9234

Example:

  ATM INTERFACE> set max-frame 1000

max-mp-parties
Sets the maximum number of leaves on a point-to-multipoint connection initiated by the device. This parameter affects system memory allocation. Increasing this value is necessary if the device must set up point-to-multipoint connection(s) to a large number of destinations.
Valid Values:
An integer in the range 1 - 5000
Default Value:
512

Example:

  ATM INTERFACE> set max-mp-parties 300

network-id
Sets the network id of the ATM interface. Multiple ATM interfaces should have the same network id if there is ATM connectivity between the interfaces.
Valid Values:
0 - 255
Default Value:
0

trace
Sets the packet tracing parameters on the interface. Packet tracing can be enabled or disabled on a range of VPI/VCI values. Common VPI/VCI values to trace are:
Valid Values:
on, off
Default Value:
off

You are prompted for the VPI/VCI range you want to trace.

Beginning VPI Valid Values:
0 - 255
Default Value:
0
Ending VPI Valid Values:
0 - 255
Default Value:
255
Beginning VCI Valid Values:
0 - 65535
Default Value:
0
Ending VCI Valid Values:
0 - 65535
Default Value:
65535

Example:

  ATM INTERFACE> set trace on
  beginning of VPI range [0]? 0
  end of VPI range [255]? 0
  beginning of VCI range [0]? 5
  end of VCI range [65535]? 5

uni-version
Sets the User Network Interface (UNI) version used by the ATM interface with communicating with the attached ATM switch. If the UNI versions are configured on the ATM switch and ATM device interface to a specific version (not AUTO-DETECT), the UNI versions must match.

If the UNI version is configured as AUTO, the ATM device attempts to learn the UNI version to use from the switch.

In UNI AUTO-DETECT mode, if the switch does not respond to the query for UNI version, the default is UNI 3.0. If the switch responds with a value other than UNI 3.0 or UNI 3.1, the default is UNI 3.1.

Valid Values:
[UNI 3.0|UNI 3.1|AUTO-DETECT|None]
Default Value:
UNI 3.0
Note:Must be compatible with the ATM switch.

Example:

  ATM INTERFACE> set uni-version 3.0

Enable

Use the enable command to enable an ESI in the configuration of your ATM device. The ATM interface attempts to register only enabled ESIs when it activates.

Syntax:

enable
esi esi-address

esi esi-address
Address of End System Identifiers.
Valid Values:
Any 12 hexadecimal digits
Default Value:
none

Example: enable esi

  ATM INTERFACE> enable esi 00:00:00:00:00:09

Disable

Use the disable command to disable an ESI in the configuration. ATM components using disabled ESIs will not become active on the next device restart.

Syntax: disable
esi esi-address

esi esi-address
Address of End System Identifiers.
Valid Values:
Any 12 hexadecimal digits
Default Value:
none

Example: disable esi

  ATM INTERFACE> disable esi 00:00:00:00:00:09

Accessing the ATM Monitoring Process

Use the following procedure to access the ATM monitoring commands. This process gives you access to an ATM's monitoring process.

  1. At the OPCON prompt, enter talk 5. (For more detail on this command, refer to "What is the OPCON Process?".) For example:
    * talk 5
    +
    

    The GWCON prompt (+) is displayed on the console. If the prompt does not appear when you first enter the console, press Return again.

  2. Enter interface at the + prompt to display a list of configured interfaces.
  3. Record the interface numbers.
  4. Enter network followed by the number of the ATM interface.
       + network 36
       ATM+
    

    The ATM monitoring prompt (ATM+) is displayed.


ATM Monitoring Commands

This section summarizes the ATM monitoring commands for monitoring ATM interfaces. Enter the commands at the ATM+ prompt.

Table 35. ATM monitoring command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Interface   Displays the ATM Interface+ prompt from which you can monitor the ATM Interface, as described in "ATM Interface Monitoring Commands (ATM INTERFACE+ Prompt)"
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Interface

Displays the ATM Interface+ prompt, described in "ATM Interface Monitoring Commands (ATM INTERFACE+ Prompt)".

Syntax:

interface
 

ATM Interface Monitoring Commands (ATM INTERFACE+ Prompt)

This section summarizes and then explains the commands for monitoring a specific ATM interface.

Enter the commands at the ATM INTERFACE+ prompt.

Table 36. ATM INTERFACE monitoring command Summary
 Command   Function 
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 List   Lists ATM addresses and VCCs. 
 Trace   Starts/Stops packet tracing on a specified VPI/VCI range. Trace can be viewed by ELS. 
 Wrap   Starts/Stops a loopback test on the VCC. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

List

Use the list command to list various categories of ATM data.

Syntax:

list
addresses

 
all

 
circuit

vccs

reserved-bandwidth

addresses
Lists the ATM addresses, along with a descriptive name, in use on the device.

Example:

ATM INTERFACE+ list addresses
 
               ATM Address                                Name
----------------------------------------  -------------------------------------
3999999999999900009999020000041347391804  LEC 1 'eth1'
3999999999999900009999020000041347391802  LES/BUS 'eth1'

all
Lists all of the following:

circuit
Lists the statistics for a particular VCC by specifying the particular VCI-VPI pair. You can also specify the circuit on the command line; for example: list circuit 33.

Example:

ATM INTERFACE+ list circuit
VPI [0]?
VCI [32]?33
 
     Frames transmitted   =         2  Bytes transmitted   =       216
     Frames received      =         2  Bytes received      =       216
 
 

vccs
Lists all the VCCs established by the device. The VCCs may be permanent (PVC) or switched (SVC), point-to-point or point-to-multipoint, and each is identified by a unique VPI/VCI. The trace command uses the VPI/VCI value for a VCC to perform packet tracing over a particular VCC.

Example:

P-P
point to point VCC
P-MP
point to multipoint VCC
ILMI
Interim Local Management Interface VCC
SAAL
signalling VCC

reserved-bandwidth
Lists the reserved bandwidth on the ATM Interface.

Example:

ATM INTERFACE+ list reserved-bandwidth
Line Rate                    : 155000 Kbps
Peak Reserved Bandwidth      : None
Sustained Reserved Bandwidth : None
 

Trace

Use the trace command activate packet tracing over a specified range of VPI/VCI values. You can view trace data by using ELS as described in "View".

Syntax:

trace
list

on

off

list
Displays the current packet tracing options on the ATM interface.

Example:

ATM Interface+ trace
on | off | list []? list
Packet trace is ON
Range of VPIs to be traced:       0 -       0
Range of VCIs to be traced:      32 -      39

on
Starts packet tracing on all active VCCs within the specified VPI/VCI range.

Example:

ATM Interface+ trace on
beginning of VPI range [0]?
end of VPI range [0]?
beginning of VCI range [32]?
end of VCI range [65535]? 39

off
Stops packet tracing on all VCCs.

Example:

ATM Interface+ trace off
ATM Interface+ trace list
Packet trace is OFF

Wrap

Use the wrap command to perform a loopback data test on the ATM interface of the adapter. Wrap can be issued on a per VC basis by specifying VPI-VCI pairs. Data is looped back internally.

You can selectively start a wrap, stop a wrap, or display the current wrap settings.

If you stop or display a wrap, the following statistics will be displayed:

For display, the current wrap statistics are displayed.

For stop, the final wrap statistics are displayed.

Syntax:

wrap
display

start

stop

display
Displays the current wrap settings.

start
Starts the wrap procedure and specifies the VPI-VCI length of pattern and the pattern itself.

Example:

ATM Interface+ wrap start
VPI [0]?
VCI [32]?
wrap pattern length [32]?
Enter 32-byte wrap pattern: [ABCDEFGHIJKLMNOPQRSTUVWXYZ123456]?

stop
Stops the wrap procedure and displays final wrap statistics.

Assign-lec Configuration Command

Use the assign-lec command to assign a specified LEC to the ATM interface.

Syntax:

assign-lec

Select LEC to assign
Specifies the interface number of the LEC to be assigned to the ATM interface.
Note:The ATM interface is selected using the net x at the Config> prompt, where x is the physical ATM interface number.

Assign-lec Monitoring Command

Use the assign-lec command to dynamically assign a specified LEC to the ATM interface.

Syntax:

assign-lec

Select LEC to assign
Specifies the interface number of the LEC to be assigned to the ATM interface.
Note:The ATM interface is selected using the net x at the + prompt, where x is the physical ATM interface number.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]